sUSEFUL 


NFOIB= 
NSUBI= 
NDIRHT= 
NTRACK= 
NBWIK= 
BSKBSZ= 
NPGTK= 


FDOFMTF/ 
DIDSCI/ 
DIDSCA/ 
DIOFN/ 

FOLOFN/ 
PFDOFN/ 
FOOFN/ 

SBIOTB/ 


ESBIDT/ 
OSKFCT/ 
DSKBTB/ 
DBT JFN/ 


JFN FOR <SYSTEMSDSKBITTBL.s1 (USE JFNOFN TO GET 


TENEX DIRECTORY STUFF 


SYMBOLS 


w PAGES IN <SYSTEMSDIRECTORY.31 (40 DIRS / PAGE) 

# SUBINDICES IN <SYSTEMDINDEX.31 

SIZE OF HASH TABLE IN <SYSTEMDINDEX.$1 SUBINDEX 0 

w DISK CYLINDERS ON WHOLE SYSTEM (MISNAMED) 

x WORDS TO REPRESENT ALL PAGES ON A CYLINDER WITH A BIT (MISNAMED) 
SIZE OF ENTIRE DISK BIT TABLE (BOTH PARTS) IN WORDS 

# PAGES ON A CYLINDER (MISNAMED) 


O => NEW FORMAT FILE SYSTEM, 1 => OLD FORMAT FILE SYSTEM 

1ST DISK ADR OF SYSTEM (NEAR SWAPPING TRACKS) 

DISK ADR OF INDEX BLOCK OF <SYSTEMDINDEX.3$1 

OFN OF INDEX BLOCK OF <SYSTEMDINDEX.31 

OFN OF PAGE TABLE TABLE OF LONG FILE <SYSTEMDDIRECTORY.3$1 

TABLE OF POINTERS TO TABLE OF OFNS FOR EACH FILE SYSTEM (JUST 1) 
TABLE OF OFNS FOR INDEX BLOCKS FOR <SYSTEMDDIRECTORY.31 | 
TABLE OF 200 7 BIT BYTE SUBINDEX PTRS INDEXED BY ASCII 

CODE OF 1ST CHAR OF DIRECTORY NAME 

HASH TABLE IN <SYSTEMDINDEX.51 SUBINDEX O 

FREE PAGE COUNT PART OF DISK BIT TABLE MAPPED <SYSTEM>DSKBITTBL.31 
BIT TABLE PART OF DISK BIT TABLE MAPPED <SYSTEMDDSKBITTBL.31 
OFN) 


@os oerinitions 


DDBDAT:!BLOCK 


LH information block 


info | 


=> pointer to special 
O means no special 
Date and time of last login 


USE TPCs0 +s Pe to define offsets into ddb 
BLOCK 1 +; Header not referenced symbollically 
DDBNAM:!IBLOCK 1 s Lh ==> pointer to password string block 
+; Rh ==> pointer to name string block 
DDBMAX:!BLOCK 1 ; Maximum disk storage for this directory 
DDOBLOG:!BLOCK 1 ; Time and date of last login 
DOBPRV:!BLUCK 1 ; Privilege bits 
DOBMOD:!BLOCK 1 + Mode bits 
DDOBRES:!BLOCK 1 + Special resource information 
DOBNUM:!BLOCK 1 + RH ==> directory number 
+ 
$ 
$ 
: 


DODBGRP:!BLOCK 
DDBLEN:! 


Groups to which this user belongs 


sUSER DIRECTORY 


QPP c== 750000 
USE 


DIRORG: 
DIRLCKs 
DIRUSE: 
DIRNUM: 
SYMBOT: 
SYMTOP: 
DIRFRE: 
FRETOP: 
DIRDPW: 
DIRPRT: 
DIRDBK: 
DIRGRP: 
DIRSAVs 
DIRDSK: 


DIREXL: 
SPARE: 
DIRLOC: 
DIRINP? 
DIRINC: 
DIRMSK: 
DIRSCN: 
FREE: 


*SUBINDEX O IN 


DIRHTO==DIRDPW 
DIRHTL==DIRPRT 
DIRDBK 
+ DEFINED LSTONO 
LSTONO==DIRGRP 


FDADR==:s 


SBIDTB: 
ESBIOT: 


BLOCK 
BLOCK 
BLOCK 
BLUCK 
BLOCK 
BLOCK 
BLOCK 
BLUCK 
BLOCK 
BLOCK 
BLOCK 
BLUCK 
BLOCK 
BLOCK 


BLUCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 
BLOCK 


frond peed Pere feet fet fect feret ] peet bed pend feet bet CO 


Lt bet bet bet bet bet et 


DEFINITIONS 


* 


$ 


DIRTPC 


Wh we we Oe WO WF OE WE BE Ct CH BF me WA we Be CA 


me we Pe Re Se RH 


Directory oriqin 


Directory oriqin 

Directory lock 

Directory use indicator 

Number of this directory 

Symbol table botton 

Symbol table top 

Free storage header 

Current top of free storage area 
Default file protection word 

Directory protection word 

Default backup specification 

Groups having access to this directory 
A place to put pointers to be gqcted 

LH = max allocation this directory, 

RH = current allocation 

=] PREVENTS EXPUNGE 

Locations for additional variables 
Temo used for saving location in the directory 
Temp to save pointer to tnput for lookup 
Ffemo to hold increment for searching 
Temp to hold mask for lookups 

Temp to save pointer to pointer 
Beqinning of free area 


INDEX.+1 DEFINITIONS USING ABOVE ALSO 


ae De Re 


BLOCK <200+44>/5 $ 


Directory number hash table origin 
Directory number hash table length 
Disc address of fd ib 

LAST ASSIGNED DIRECTORY NUMBER 


Directory subindex dispatch 


;FDB DEFINITIONS 


USE TPC,0 Pe to use to define fdb offsets 


wa % 


BLOCK 1 
FDBCTL*!BLOCK 1 


The header, not referenced symbolically 
Lh ==> control bits (see below) 
Rh ==> location of file name block 
Lh ==> location of extension block 
Rh ==> pointer to other extensions 
The file address & class field 
File protection word 
Creation date & time of version 1 
Lh ==> last writer directory number 
Rh ==> use count (+1 for each indirect pointer 
and saved environment) 
Lh ==> version number 
this is job number for temp files 
Rh ==> pointer to other versions 
Account infor for charging 
+ for location of string block 
= for number 
O=5 ==> number of version to retain 
6*1]1 ==> last byte size 
Rh ==> count of actual pages in file 


FOBEXT:!BLOCK 1 


FDBADR:!BLOCK 1 
FOBPRT?!BLOCK 1 
FOSCRE:!BLOCK 1 
FOBUSE:!BLUCK 1 


FDOBVER:!BLOCK 1 
FDOBACT:!BLUCK 1 


FOBBYV:!BLUCK 1 


FOBSIZ?:!BLOCK 1 Length of file in bytes 

FOBCRV: IBLOCK 1 Creation date and time of this version 
FOBWRT:!BLOCK 1 Date & time of last write 
FOBREF:!BLOCK 1 Date & time of last reference 

MEBCNTS IBLOCK 1 Lh ==> count of writes 

_ Rh ==> count of references 
FDBBCK:!B8LOCK 5 Words for backup system 

FOBSUSW:!IBLOCK 1 User settable word 


On On Pt we OH RH Se Se BH He OH WH Me WE Be we OE TS OH Be we HS we HH He Be Me HH we 


FOBLEN?: Lenath of fdb 


; Bits in Ih of fdbctl 
FDBTMP==400000 


FDBPRM==200000 
FDBNEX==100000 


File is temporary 

File is permanent 

No extension for this fdb yet 
the file does not really exist 
File is deleted 

File does not exist (first write not complete) 

Long file 

Compressed page table 

Environment file 

Subroutine file 

Undeletable file 

Ephemeral subsys file 


FDBDEL==040000 
FDBNXF==020000 
FOBLNG==010000 
FDBSHT==004000 
FDBENV==002000 
FOBSU6B==001000 
FDBUND==000400 
FDBEPH==000001 


2S BP Be SH We BE We we 9 we Be GA 


CSYSTEMSDSKBTTBL. 31 


oy: JFN FOR FILE 
MAPPED INTO ADR SPACE AS FOLLOWS: 


8 ae ee am Oe Oe OO Oe OE OS OO OO a a 


DSKFCT: ! FREE PG CNT CYL O 


t ie ie Oth Ok ek ie OE OO ee 


: FREE PG CNT CYL 1 


! FREE PG CNT CYL 2 


INITED TO NPGTK 


rl 
ond 


we] 
” 
re) 


S 


M™~ 


: 
! 
' 
: 
: 
: 
: 
: 
! 
: 


t 


—~ @¢ 


_ a na ee eee me ee ee 
ee eee ee ee ee eee ee 


1 BIT PER PAGE 
FOR CYL O 


om 
8 
8 


DOSKETB: INITED TO BIT=1 UNASSIGNED 


FOR ALL EXISTANT PAGES 


1 BIT PER PAGE 
FOR CYL 1 


fom ban ae FOR fe ee 


<= 
mf 


[ee ee Le ce ee | 


' 

! 

' 

ij 

‘ 

t 

ACK > NBWTK 
ee 
: 1 BIT PER PAGE 

FOR CYL 2 

f 

i 

: 

t 

i 


® 
ot oe GR eh Oe OR OE Os os ss 


a Fm Fe tam Rome FR Om Hee OomH Fm fom oe Sa Cam com pam mm fame TR fant kom fet fmm ome 


Ce ek ee ee ee ee ee er 


err 


D1 


DIDSCA==>! Be 


DSCI 
/ 
V \ 


\ues Be 


CSYSTEMDINDEX.31 


PAGE TABLE 
1 oo we es oe es oe oe ae ee oe os oe 
WORDS 


: 8. WORDS 


leew ee ef 
5 &. WORDS s 
leaweanaenam meee I 
! &. WORDS ! 
[enue aennsn am | 
' 8&8. WORDS t 


Yen ee ee ce ee ee 


Q : 


7 
[eee ee et 
t 


‘ 


* NSUBI WORKDS 


fame ae >t 


twa 


ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee el 


\==>! 


SUBINDEX 0 


l eee COR ee ee | 


DIRLCK (ALSO DIRORG) ! 


laseusan eens ese eee eee eee |! 


' ODIRUSE ! 
0 ue oe a oe Oe Oe Oe Oe Oe ee Oe Oe Oe Oo ee I 
' PIRNUMs O 5 
lemme aman eee ese same ee eet 
! SYMBOT ! 
| eases anne near naemanme awe | 
! SYMTOP ! 
[ wee wee eR SB BBE eee ee! 
! DPDIRFRE HEADER BLOCK ! 
! 7%. WORDS ! 


! FRETOP 
| eau wee een eee eee eee eee t 
! DIRHTO ! 
[eeu ase nee eee eee eee eee | 
t  DIRHTL ' 
eee ee ee a ee te 
! FDAOR 
[eases eee nene sees wee ! 
! LSTONG ! 
[anew eee eee ee Bee eae eee oe t 
! 9. UNUSED WORDS 
' 
fan ue eB eR BBE HE 
SBIDOTB (ALSO DIFREE) 
26. WORDS 
200 7 BIT BYTES PTING 
TO SUBINDEX. BYTE 
INDEXED BY ASCII CHAR 
ESBIDT (HASH TABLE) 
NDIRHT WORDS 
DDB OFFSET,,DIR # 


0 


' oe ot oe GE OP OE OE 


: 0 
t BSCS SBS OBB SESE Bee oe 


ee ee ee ee er eh ee er) 


oom 8me Ft Ro tem Pent fam FO Cem tem fe PO Om Ft Ee fe Fe 


SUBINDEX 0 < N ¢ NSUBI 


[aes eR eS Renee et 


DIRLCK (ALSO DIRORG) ! 


lease eee ene eee eee ee | 


f DIRUSE : 


fo) 
Q 


OR | 


SAGES (4K) 


| <= oor fom 89R Fe fam Be Ca Fe OR fe OP he Cam FO fom Cem Ga Oe Pe fe FR ek fe 


! ODIRNUM: ©N 4 


4 ae am ae Oe we Oe Oe Oe Oe oe ne ee ae Oe 


! SYMBOT 4 


' BEER RRS SEES TEKS OBOE enBnBaas t 


' SYMTOP 


DIRFRE HEADER BLOCK 
7s WORDS 


FRETOP 


13. UNUSED WORDS 


DIFREE FREE STORAGE 
DDBS AND STRINGS 


DDB 


' SERPS SE SS ' 


' 1l,,sDDBLEN : 


(wesc oe | 


! DDOBNAM : 


iscuaecs cas nesaema wae memes | 


! DOBMAX 


' DDBLOG : 


feaus nee easanuanews | 


! ODBMOD ! 


! DOBRES : 


leaeee ete ase nae owe f 


! DDBNUM : 


[mene neeeseeeeenaweme | 


! DOBDAT : 


fees eee een eee emt 


! DDBGRP : 


lasses eae eee ee t 


0 
! CERES CBR SCSOHS PHSB BSS oe oe 
: 0 
' SRS BSR ESSE MSE eS 


! 


Ch Fe Ge SOR Rm Fo Fe Ram Fee Rem COR bem fa Fp fe Ge FO Gh fee Ga fem Pe DO Pom fam Fa Com RO NO Ga Pe fm Fe Ge 
Ro Fe Ree Fem Fe OR Re tm A Ge Re fe Gam FP Oe OR Gm Ot Pm fe CR RO Ge Qa Com Ge ge fe CO Po fm A fo Raw Pam Gee fet 


ome Gomme tam 


e 


A 


om 
S 


é Ce er ee ee ee ee ee ee ee em el er ee 


GS (4K) 


OQ 
oO 


|] a ee ee | 


CSYSTEMODIRECTORY.31 


NEW FORMAT (FOFMTF: 


0} 


Ae 
t 


/ 
/ 
! PTT 

\ iene oe | 
FDADR@=>! 1 WO 
+ 1 mm eee oe oe oe oe f 
: ' 1 WO t 
NEFDI6B {ames ese | 
! ' 1 WO Lu 
' tunes oe | 
V Foi we : 
-—o funnenwme | 
: 0 ! 
faeawew ews 
‘ 0 : 
tm ewe me ee I 
: 0 ! 
leacawa mma f 


: ° : 


Ce ee ee ee ee ed a” 


s 


. X 


UFNS 


¥ cc one as oe es oe F 


FOOFN: ! 21 WD tes 


Y om eon on cx coe of / 


wr oom fm fo 


Same me > 1 


/ 


ee ee ee ek ee ee ee ee 


a” hm oom oe 


=>! 


DIRS 
lawman ae t 
20 PGS ! 
fanaa mw |} 
20 PGS ! 
[ume eee | 


20 PGS ! 


feasnanswem t 


20 PGS ! 


lesen ommean | 


20 PGS ! 


fasnmewoee | 


20 PGS ! 
fesusmaam | 
20 PGS ! 
fannnanam | 


€ « « s 


PT 0 


5 oe me oe a oe oe oe ef 


20 WDS 


fewer | 


' 20 WDS 


{aoe wm I 


! 206 WDS 


leeuvaunanm | 


' 20 WDS 


fou emcee | 


' 20 WDS 


1 oe oe ef 


' 20 WDS 


' 20 WDS 


{ coc mm oe ft 


lenme=>! 
[eaoe=>! 
faamae>! 
[emeee>! 
[ammen>! 
[euman>! 


Toammam> f 


e e 


PT l 


1 mee me es oe | 


20 WDS 


foment 


' 20 WDS 


foannamu mm | 


! 20 WDS 


Venera: meee f 


! 20 WOS 


{se oe oe et 


’ 20 WDS 


$ mm on oe oe oe ost 


! 20 WDS 


fence see ! 


£ 20 WOS 


tas os om oe oe ee oe ae 


 pIRS 
faununenanme ! 
20 PGS ! 
taaweneme | 
20 PGS ! 
fasenanwme ! 


20 PGS ! 


foeee mee ft 


20 PGS ! 
fwomemmene } 
20 PGS ! 
lascuwmee | 
20 PGS ! 
taeuneune ! 
20 PGS ! 
leuannanae ! 


! ! 


€ . * e 


lewwee>! 
lememne>! 
lwnnen>! 
[enwmm>! 
[ammen>! 
lmemee>! 


luamaam ft 


€ s 


* e 


DIR 
DIR 
DIR 
DIR 
DIR 
DIR 


DIR 


DIR 
DIR 
DIR 
DIR 
DIR 
DIR 


DIR 


Tt 


<SYSTEMDDIRECTORY.«31 QLD FORMAT (FDFMTF: 


“1) 


Baccne-s 
! 


/ 
/ 
: PTT 
\ 1 oe ae ee ae oe ce 
FDADR*=>! 1 WD 
” fanaa ow es 
Ps 
NFDIB lsssseces 
! ' 1 WD 
! imeem ee 
V ' 1 WO 
pee tenet 
! 0 
¥ me oo oe ee me es oe 
: 0 
lesan ams 
: 0 
¥ ae oe oe on om oe 


t 


« 


OFNS 


} oe oe oe ee 


FDOFN:s ! 27 WD 
“~ teense om me 


1 W 


| ac oc eee me ee 


V ' 1 WD 


laesees ue = 


taewnwe >! 


: 
t 


cm 


Cre ee ee De 


Crm Rob ta bam 


Om fom nam foe Oe 


a“ 


pom Com aoe Co Cm Fe GP fo Ram Re fe 


cam tf) FOP hoe 


LJ 
~ 


=/ 


oom 


~ 


tt fom cmp Om a Fe ee fee OP fe fam fe Samp feet 


mh Ct Om CF 


PT 0 


to oo oe t 


10 WDS 


torn me oe | 


' 10 WDS 


¥en x oe ee oe ee | 


' 10 WDS 


tenn am eee | 


! 10 WDS 


Y x on om one os enon f 


! 10 WDS 


leanne | 


£10 WDS 


{am ef 


! 10 WOS 


1 x on on oe eo es | 


DIRS 


luonmawmae t 


10 PGS ! 


faaanenee t 


10 PGS ! 


tan nmeamaamu f 


10 PGS ! 


fou nameme | 


10 PGS ! 


foesuenmame | 


10 PGS ! 


fuanaomee | 


10 PGS ! 


taauneaams ! 


ammen>! 
[eamne>! 
lenmen>! 
[onmen>! 
[eamee>! 
leemen>! 
[mnwwmn>! 


teanoummn | 
t f ¥ t 


€ « * * * 
€ e 


PT NFOIB/2 


lane mawe | 


DIRS 


faunamames ft 


Neo! 10 WOS feaesen>t 10 PGS ! 


} coe eee ee F 


! 10 WDS 


€ en ee om I 
a * 


£ 10 WDS 


tuanmaomeame ft 
. . 


! 10 WDS 


lessanmaaem ft 


' 10 WDS 


' 10 WDS 


laasnememe | 


! 10 WDOS 


1 oven ee on on os oe f 


laenoamm ae f 


10 PGS ! 


fenunanawm f 


10 PGS ! 


faa nnwnee f 


10 PGS ! 
leanne e f 
10 PGS ! 
tamammaewm I 
10 PGS ! 
foam meow me t 
10 PGS ! 
Sameer F 


! ! 


¢ e . 6 


[emmee>! 
[eewee>! 
fenwen>! 
lwmmem> | 
leumee>! 


laamaw> ! 


6 6 


10 PGS !. 


iST 
1ST 
1ST 
1ST 
1ST 
1ST 


1ST 


2ND 
2ND 
2ND 
2ND 
2ND 
2ND 


2ND 


HALF 
HALF 
HALF 
HALF 
HALF 
HALF 


HALF 


HALF 
HALF 
HALF 
HALF 
HALF 
HALF 


HALF 


DIR 
DIR 
DIR 
DIR 
DIR 
DIR 


DIR 


DIR 
DIR 
DIR 
DIR 
DIK 
DIR 


DIR 


USER DIRECTORY 


DIRLCK 


DIROURG: 


DIRUSE 


DIRNUM 


SYMBOT 

SYMTOP 

DIRFRE HEADER BLOCK 
7s WORDS 


FRE TOP 


Coe fem FP fet OM A eo Ga SR Oo ap Fe Fem Oe 


DIRDPW 20 PAGES (8K) 


DIRPRT 


t 
' 

i 

! 

! 

t 

' 

i 

' 

' 

t 

i 

' 

t 

! 

' 

' 

' 

i 

t 

§ DIRDBK 

! DIRGRP 

! DIRSAV 

¥ 2k Oh OE OE OR SE OS Oe ek SP OK OE OS SO OO es 
! DIREXL 

t BREE BE ROE BH SS eo 
I 
1 
! 
! 
' 
f 
! 
' 
! 
: 
: 
} 
! 
: 
: 
: 
: 
! 
: 
! 
: 
: 
: 
' 
: 
: 


SPARE 


2 On OS On Oe Oe Oe OE oe Oe Oe oe Oe 


DIRLUC 


DIRINP 


DIRINC 


DIRMSK 


DIRSCN 


DIRGRP 
DIFREE FREE STORAGE 
FDBS AND STRING BLOCKS 


BLOCK TYPES: 
4001005+sLEN 
400001,,LEN 
4000025-sLEN 

™“1,eLEN 


FOB 
NAME 
EXT 
ACCT 


hor Won 


FDB 


iwc een ene ase eee ee fT 


ee tee oe Feet Ome fant Se OP Fat sae FO GoM pew sae fm Sot Gum Fm Sr ER SOHN Bam doe FU Hem ert fam Fo Grn fae fom Beet pee ome cae Har “E") foe fe fet fam fem fm fam fom Fat Com Gum nee fom fem of 


Co er ee ee ee ee ee ee a ee ee ee ee ee es ee ee ee ee ee ee ee ee ee ee ee) 


! 400100,,F0BLEN 3 : 7 


Set SR pom FP OU Com fn NO AO Fe fe FP he bt Fon OE On Ray oO fe ee fee ap FS fee ke GD fe fee pe FF FO fe ne fee Sm fet nee fee fo fr Ree Oe fe 


4 ae ee ee oe Oe a ee ee 


' FOBCTL 


Fae oe 20 oe on oe Oe oO as 


' FDBEXT 


2 ee om mm oe ae on Oe oe 


f FOBADR 


0 cae a om a cor mt Oe oe oe 


1 FOBPRT 


tom Cm tam 


' we GP OE HE OE OK OF OS Oh ee OE a OE Oe OS OS Oe 


FOBCRE 


FDBUSE 


FOBVER 


Cm aap OP Com ap fet Fh OP fe OR Rae Cow 


FDBACT 


FOBBYV 


! _FOBSIZ 
1 FOBCRY anaes 
FOBWRT 
1 FDBREF - 


sees ene eee 


!  FOBCNT 

| ar amt On ms Oe Oe Oe Os a Oe Os 
' FDBBCK 

! 5 WORDS 

{ ae ae on en ne ce Oe Oe Oe oe 
! FOBUSW ' 


! 
lege een ese eee et 


mm 


fm 6 


i 
! 
: 
t 
! 
: 
: 
: 
i 
: 
: 


ee ey er er ey er | 


SORTED 
SYMBOL TABLE 


! NAME PTR»sFDB PTR ! 


Eas om me ne oe om oe Oe os oe os ee oe en  F 


! NAME PTRssFDB PTR ! 


Loe” er ee ee Bee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee) 


ce ee ee ee ee ee ee ee ee ee ee he 


: 
: 
: 
! 
! 
! 
: 


t CL ee ee ee ee er ee ee ee 


") 
© 


| ee ee ee ee eee ee ee er ee 


POINTED AT 


BY SYMBOT AND SYMTOP 


sASSEMBLY OF SENSITIVE PAGE HARDWARE ADRS FOR ASSIGNMENT TO ERROR FREE AREA 
3GN CDC WINCHESTER DRIVES 
YL O, HEADS 0 AND 1 ARE AVAILABLE. 
sMEAD 1 IS ASSUMED SAFER THAN HEAD O (LESS CHANCE OF HUMAN ERROR CLOBBERING IT) 
sCYL Os HEADS 0 AND 1s SECTOR O ARE ASSUMED UNSAFE (MUCH CHANCE OF HUMAN ERROR) 


sLAYOUT 
DENOTES MAY NOT BE PRESENT (USUALLY ONLY FOUND ON PACK O OF A STRUCTURE) 


% 


CYLINDER Os HEAD O (TRACK 0) 


SECTOR ¥ 
0 1 2 3 4 5 6 vi 
£ CORE ' HOMBAT ! HOME ! BAT ! MONITOR ! CORE ' CORE 


! DMP 766 ! FILE 2 BLOCK 2 ! BLOCK 2 ! «SAV DMP 256 ! DMP 512 
! XB % ' XB 1 XB £ XB %* 1 XB * 


vont som # 
od 
7 tm > 


CYLINDER O, HEAD 1 (TRACK 1) 


Oo C6 we CS 2s GO BSE Be we Se Wt We we BA Be Ge BF wt We We 


SECTOR 3 
0 1 2 3 4G 5 6 7 
! CURE ' HOMBAT ! HOME 1 BAT ! MICRO ' MICRO ' BOOT 
' DMP 1024! FILE 1 ! BLOCK 12 ! BLOCK 1 ! CODE £ DIAG ! STRAP 


mn 


£ XB * ' XB : ! XB £ XB 1 XB 


HOME BLOCKS 


@... ALL OISK ADDRESSES ARE IN HARWARE FORMAT SPECIFIED BY HOMHWO. 
EACH 9 BIT FIELD SPECIFIES + BITS IN RESPECTIVE FIELOS OF 
HAROWARE FORMAT DISK ADR. CURRENTLY 6.;1305s8098. 


* => ADR MAY NOT BE ON THIS PACK (PTS TO ANOTHER PACK IN STRUCTURE) 


Ue ce ae a sO a Oe OO OE OE OO EO Oe a aE 
HOMNAM ! "HOME ! | too 
lee ee RENEE TE RENE RETR ee oe 
HOMID ‘Ip! ! 

[ sees ee RB RRS TBAB nee | ' 
HOMVER ! VERSION 4, LENGTH (WOS) sseemeetee>! 
t 


2 cm a ae oe a a Oe 


HOMHWO ! UNIT BITS, CYL BITS 5,5 SRF BITS, SEC BITS 


0 eae a ee ae en ee ES 


HOMHW] fo CYLS THIS PACK 55 # SURFACES THIS PACK 


Ue cae ee ae Oe Oe Oe OO 


HOMHW2 : wv SECTORS 7 TRACK s+ # WORDS / SECTOR 


ee 


HOMHW3 ! ou SECTORS / THIS PACK »5 wv SECTORS / CYL 


2 aoe as ms eee Oe Ha A 


HOMHW4 UNUSED 


Ve 


MHB1 ‘ PRIMARY HOMBAT XB ADR 


9 nae cn ce Se ee ae Oe EO ES SE A OS OE OO OE OO OS OE SE EO 


HOMHB2 ! SECONDARY HOMBAT XB ADR 


$e mae ce om nae a me Oe ee EO OO OO 


HOMMDA t MICRO DIAG XB ADR 


2 ame ae me OE Oe we ee ee Ee Oe Oe 


HOMMDF ! MICRO DIAG FLAGS 


9 cae se sO See EE ES 


HUMMCA ! MICROCODE XB AOR 


HOMMCF i MICROCODE FLAGS 


Yat eae a OO ae Oa ae OD ee OE OO Oe EO SS Oe OO Oe OO 


HOMBTA ' BDOTSTRAP XB ADR 


HOMBTF : BOOTSTRAP FLAGS 


ae moe ce Oe ae ee Oe Oe OE EO OO Oe ee 
4 


HOMMNA : MONITOR XB ADR 


tL 


HOMMNE ! MONITOR FLAGS 


© caus sa ee Se ae Ot OO 


HOMCOA * : CORDMP.256 XB ADR 


9 ca a a a ae Pe OO Oe OO 


HOMCOF : CORDMP.256 FLAGS 


HOMCILA * : COROMP.51i2 XB ADR 


9 ea ae ae ee sm ae TE 


@ar : CORDMP.512 FLAGS 


Fs ame ae OE AO ae Oe OO OS 28 


HOMC2A * : COROMP.768 XB ADR 


9 cee on cae Oe a a am 0 eS OE OO 


HOMC2F : COROMP.768 FLAGS 


Com em Rot fom TD Ce Rom Pe Fam gap Ca Pe FR Ao FR oa HO OO hme La FO Nag Lemp Ho Ce Game Fm Fm Het Ge Ht RP Oe Ree Gm ao OM he RO a Ree feet 
oa fe Rao Ca OO OD fem FO fom Ram A Fe CO Su FO Oe Ra ft Pe Fo Fo Oa FOR Gam han em Om Re A Fo GO oh om fm a Fm a om ON fam Oe 


HOMC3A * ! CORDMP.1024¢ XB ADR | : 


HOMC3F i CORDMP.1024 FLAGS f 


MSNM : "STRUCTURE NAME! 4 


HOMSFG : STRUCTURE FLAGS 


HOMSPK f TOTAL STR PACKS 55 THIS PACK = 


! 2 Oe Oo Oe ee Se SS Oe OP Ge Oe OE GD OE OE ee OS Oe GE Oe OE OE Os es ss Oe 


HOMPFG THIS PACK FLAGS 


HOMSWP 1ST SWAPPING CYL sy LAST SWAPPING CYL 


1 ow or ae oe 2 OS OS Ot Ee OD Oe OE OE Oe Se EO as Os ee 


HOMNX1] INDEX-s1 XB ADR 


Lj 2 22 OE BS OD Gt ES OF OE SD Oe GE OR OD OS OP OF SS OE SD OP OE OS OS OS OE Oe OE OP OF OE Oe DO Oe oe Oe oe OO 


HOMNX2 * : INDEX.«$2 XB ADR 


HOMDR1 * : DIRECTORY.«:1 XB ADR 


HOMDR2 * : DIRECTORYes2 XB ADR 


' 2 Oe oe OE Oe OE OO OP Oe OS OS OE Os OE Ss Os sO Oe a a oe 


HOMSPR : SP ARE 


mh Rem Ra OH OM fe Fe OO OP fa Om Pa fe Ae Co fe ee he A fo 


: 
Fa ee Se OS OF OP Oe OS OE A OE AE EE a Ae ES SO OO OE OB f 

SPARE | ! 

! SP OE OO OE Oe OS OE EO EE SRSA REE SE ' 

HOMCOD 707070 
' 


' SPCC SCE SRST KC PS KEPT BECKERS SC CSS SS OS Se ee 


HOMSLF : THIS HOME BLOCK ADR V 


Oe ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee) 


om 


WROTE: 


BATNAM 
BATID 

BATVER 
BATHWO 
BATHB1 
BATHB2 
BATFRE 
BATCNT 
BATSPR 


deh TDAT 


BATCOD 


BATSLF 


SINCE THE UNIT FIELD OF THE DISK ADR IS MEANINGLESS, 
COUNT OCCUPIES THAT FIELD. 


' 
° 


BAT BLOCKS 


SECTOR 


ALL DISK ADDRESSES ARE IN HARWARE FORMAT SPECIFIED BY BATHWO. 


: ‘BAT! : 
F eet on On ann es Se a a Ae ee PO OO ' 
: ‘15° : 


t OO U8 Ob OR Oe tO OP Ee Oe a a SS uj 


! VERSION 5,5 LENGTH (WDS) =sseee+= 


* « 


! CNT BITS, CYL BITS +s SRF BITS, SEC BITS ! 


: PRIMARY HOMBAT XB ADR (PACK RELATIVE) 


t RRR SOCK ESESRESE ESTER SE SCE E BSBA RKRERAR HE Se Swe 


! SECONDARY HOMBAT XB ADR (PACK RELATIVE) 


tie ee Oe SERS RRS GCSE STB eRe 
e 


: FREE COUNT 


: INITIAL COUNT ay ADDED COUNT 


! 2 OF 2h OE OE Bt Ot OE SS Os OR OE OS OE OE OD EE OE OE OE OO Os ss ss sO 


: SPARE 


! SECTOR CNT ! START ADDRESS (W/O UNIT) 


! SECTOR CNT ! START ADDRESS (W/O UNIT) 


: 


Cre ee ee ee ee ee ee ee ee ee ee ee 


e 
a 


* 
t REPS SPECS BERHE SSE KOSH KSESSEBCHEWSSE BSCS SH HSE SBS 


! SECTOR CNT ! START ADORESS (W/O UNIT) 

: 0 

© cat a Oe te 00 ae ae Oe se Oe a Oe OO 2 Gt a Oh Oe a oe 
: 0 

9 ae ee ee ee a ee 
' 606060 

f OE SRE SKREENED TES SEEK SOB 


: THIS BAT BLOCK ADR (PACK RELATIVE} 


t oc 2 OO OS Ge Oe oe Oe Oe Oe se et a oe a oe 


: 
t 
f 
: 
: 
! 
J 
§ 
: 
! 
t 
: 


=? 


+ 


: 
: 
: 
: 
: 
: 
: 
: 
! 
: 
: 
: 
: 
: 
: 
: 
: 
: 
: 
! 
: 
: 
: 
! 
: 
i 
: 
: 
! 
: 
: 
! 
' 
V 
-= 


;DSKPAR GTTA8 FABLE = USED BY CHECKDISK,BLKLUK sSWPBAT, MAYBE OTHERS 


KPAR?: LOTRK 30 = FIRST CYLINDER ON STRUCTURE 
HITRK ;1 = LAST CYLINDER+1 GN STRUCTURE 
NSECTK 32 ™ i SECTORS / CYLINDER 
NWSEC 33 = « WOROS / SECTOR 
NTKUN 34 = © CYLINDERS / PACK 
NPACKS 35 = 3 PACKS ON STRUCTURE 
SWPTK 36 = OTH SWAPPING TRACK ON A PACK 
SWPTKH ;f = LAST + 1 SWAPPING CYLINDER ON A PACK 
NSURFS +10 = SURFACES OR HEADS / PACK 
NSECS >;11 = & SECTORS / TRACK (NOT PER CYLINDER) 
NSECPG 312 = 7 SECTORS / PAGE 
NBWTK 713 = # BITTABLE WORDS / CYLINDER 
DSKBSZ 3:14 = SIZE OF BITTABLE (COUNT + BIT AREAS) 
NMINFP 315 = DBSKASN FREE CHOICE PARAMETER 
= DSKMSK,,e1 316 = MASK OF BITS IN SOFTWARE ADR 


CNUNTBT>BS+<NCYLBTDB1 7+<NSRFEBTOB264+<NSECBIOB35 317 = G BIT HDOWR SPEC 
POINT NUNTBT,0,UNTLSB 320 = UNIT PART GF HOWR DISK ADR 

POINT NCYLBT,0O,CYLLSB ;21 = CYL PART OF HOWR DISK ADR 

POINT NSRFBT.O;SRFLSB 322 ™ SURFACE OR HEAD PART OF HDWR DISK ADR 
POINT NSECBTs05SECLSB 323 = SECTOR PART OF HDWR OISK ADR 


NDBSKPR==.*DSKPAR sNUMBER OF WORDS IN THIS GTTAB TABLE 


sHOMBAT PARAMETER TABLE 
s>SPECIFIES WHERE VARIOUS HGMBAT RELATED PAGES LIVE 
eo: MEANS ON ALL PACKS, OBO MEANS ON PRIMARY PACK OF STRUCTURE ONLY 


HOMBAT: VERKHOM,»sHOMLEN ;LATEST HOME BLOCK VER,,LEN KNOWN TO MONITOR 
VERBAT,,BATLEN sLATEST BAT SLOCK VERs,sLEN KNOWN TO MONITOR 
FREBAT s;INITAL FREE COUNT FORK VERBAT VERSON OF BAT BLK 
BATSCT >POINTER TO SECTOR COUNT FIELD FOR VERBAT 
BATADR *+POINTER TG HDWR DSK ADR FIELD FOR VERBAT 
PRMUNT >PRIMARY UNIT OF A STRUCTURE 


LIBO!N<CYLALLOB<CCYLLSBO! CSRFXBIOB<SRFELSBO!<CSECXBIDBCSECLSB> 3X61 
LBOI<CYLALLOBCCYLL SBD! <CSRFHM1>B<CSRFLSBO!ICSECHMIOBCSECLSB> SHM1 
IBO!<CYLALLOB<CCYLLSBD! <SRFBBI>B<SRFLSBO!I<CSECBBIDBCSECLSB> 3BB1 
LBGICCYLALLOBCCYLLSBD!<SRFXB2>B<SRFLSBO!I<SECXB2>BCSECLSBD> 5XB2 
IBOP<CYLALLOB<CCYLLSBD! CSRFHM2>B<SRFLSBD!<CSECHM2>6<SECLSB> $HM2 
LBOP<CYLALLOB<CYLLSBD! CSRFBB2>B<CSRFLSBO!I<CSECBB2>B<CSECLSB> $BB2 
IBOF<KCYLALLOB<CYLLSBD I CSRFMIC>B<SRFLSBOIECSECMIC>B<CSECLSBD> §MIC 
L1BO!<CYLALLOB<CYLLSB>!<SRFMCDOB<SRFLSBO!I<SECMCDOBCSECLSB> 3MCD 
IBOI<CYLALLOB<CYLLSED!<SRFBOTOB<SRFELSB DIE CSECBOTDB<CSECLSB> ;BOT 
1BO!<C YLALLDOB<CYLLSB>! CSRFMONDB<SRFLSBDI<SECMONDBCSECLSB> 5;MON 
OBOI<CYLALLOB<CYLLSBD! <CSRFCDODB<SRFLSB>ICSECCDODBCSECLSB> $CDO 
OBOT<CYLALLOB<CYLLSBD! CSRFCOISBCSRFLSBOI<SECCDIOBCSECLSBD 5;CD1 
OBUICCYLALLOB<CYLLSBS !<CSRFCD2>B<SRFLSBD>I<CSECCD2>BCSECLSB> 3CD2 
OBO! CCYLALLOB<CCYLLSBD!<CSRFCD3>B<CSRFLSBO!<SECCD3>8<SECLSB> ;CD3 


NHOMBA==."HOMBAT 


TYMOP JSYS DOCUMENTATION 
TYMOP JSYS 654 


@..... utility OPerator; performs a variety of TYMNET utility 
functions. 
Accepts in 1: O=8 option bits 

GS-17 function 

15835 TYMNET tty desiqnator (400000t#N) 


2 & 3: function dependent arquments 


TYMOP 


Returns + 1s Unsuccessful, with error number in 1, and if supervisor 
error, Subervisor error number in 2 
2% Successful: 1,2 & 3 possibly updated 


NOTES ON CARRIER OFF INTERRUPTS: 


Carrier off interrrupts for tymnet lines will be issued as usual via 
@: terminal interrupt word for the job. Controlling terminals for 

bs will result in termianl code 30 ints when zapped. 
Non=controlling terminals will result in terminal code 32 ints when 
zapped. That means aux circuits on the initiating end and terminating 
end will both get terminal code 32 ints unless those ends wind up 
being controlling ttys for some job in which case their zapping will 
result in terminal code 30 interrupts. 


NOTES ON HOST*™BASE, BASE*HOST MESSAGE CODES: 


S$Sage codes may be sent for a line (if allowed via RU,SU.RW,SW bits) 
Via the SNOCMD TYMOP function. 


Reception of message codes may cause interrupts to user programs 
on assiqned channels for appropriate terminal codes via the 
SETINS TYMOP function. 


The state of the tables related to the reception interrupts may be 
obtained via the GETINS TYMOP function. 


The last message code recvd may be obtained via the GETCMD TYMOP function. 


See TYMNET DOCUMENTATION for description of mnessage codes and their 
functions. 


A peek at TYMSRV internals documenting which message codes 
are available for recv/send by user;wheel and how codes are handled: 


ARGUMENTS: NAME, LABEL, TYPEs (USER/WHEEL RECEIVE/SEND STATUS) 
DEFINE MESAGE (NAM,LABEL, TP »RUsSUsRW, SW) 


NAM => INTERNAL NAME 
LABEL => HANDLING ROUTINE 


@ => tee oF messace 


RU => RECEIVE USER OK 
SU => SENG USER OK 

RW => RECEIVE WHEEL OK 
SW => SEND WHEEL OK 


JRST INVTYP 20 tllegal type 

MESAGE (ANSsIGNORE,sA+0,0;0,0) sl system is answering 

MESAGE (SHT,.IGNORE,A;s0,0,0,1) s2 system is up but shut 

MESAGE (CRSsCRSHsA5s0205051) 33 sender is crashed 

MESAGE (DIE, IGNORE ,A.0,0,0,1) 74 recipient should crash 

MESAGE (NSP,NEWSUP,450,0,030) »5 base taken over by new supervisor 
MESAGE (LOG,LOGGER,Bs0,0,0,0) 36 logins next 4 data chrs are 


+;the info about terminal types and port 
;OFr oriqgin,y then names etce 

MESAGE (AUX,AUXLOGsBs05050,0) >? supervisor response to 
sestablishing auxillary circuit 

MESAGE (NOP,BPON,.B,0,0,0,0) 310 backpreasure on 

MESAGE (OUP,BPOFF 5B s0.050,0) sll back pressure off 

MESAGE (GOB,GOBBLE;Bs1,1,5151) 312 character gobbler 

MESAGE (ZAP,ZAPPER,B;0,0,0,0) +13 circuit zapper 


MESAGE (EDC,EDECsBsylsls1,1) 314 enter defered echo mode 
MESAGE (LDCsLDECsBelsls1s1) 315 leave deferred echo mode 
ME SAGE (GRN,GREEN,Bs,1l,131.1) +16 green ball 

MESAGE (RED»sREDsBslslsl1ly51) 317 red ball 


MESAGE (YEL,YELLOW,Bel, eee #20 yellow ball 
MESAGE (ORG,YELLOW.Bs1,.1,1,1) #21 orange ball 
MESAGE (HNGs IGNORE 5B s13051,0) ;22 hang character * not used 


MESAGE 
MESAGE 
ME SAGE 


ME SAGE 
MESAGE 
ME SAGE 
ME SAGE 
ME SAGE 
ME SAGE 
ME SAGE 
MESAGE 
MESAGE 


ME SAGE 


MESAGE 


ME SAGE 


MESSAGE 
ME SAGE 
ME SAGE 
ME SAGE 
MESAGE 
MESAGE 
ME SAGE 


ME SAGE 


MESAGE 
ME SAGE 
MESAGE 
MESAGE 
ME SAGE 
ME SAGE 
ME SAGE 
ME SAGE 


(ETM, IGNORE, Bslsls151) 
(LIM, IGNORE sBsl-1,1-1) 324 
(LOS,BLACKsCylslsis1) 325 

sbuffers. 


323 


enter 2741 transparent mode 
leave 2741 transparent mode 
lost balls 


smany were Jost 
Supervisor request (aux circuits) 
supervisor response (aux circuits) 


(SUP, IGNORE ,C51+05,1,0) 326 
(SUR ,»SUPRSP .C.050,1,0) 327 
(AXC, IGNORE ,»C.,0,.0,0,51) 330 
(TSP, IGNORZ 9F 0405030) 331 
(TSR, IGNOR2Z,F5050,0,0) 332 
(SAD, IGNOR2,F5050,0,0) 333 
(ECN, IGNGREsB8sls151;31) 334 
(ECF, IGNORE sBslslelsl1) 335 
(TCS, IGNORE ,»Dslsls1l,1) 336 


>byte 


echo 


supervisor string character 
test pattern probe 

test pattern response 

host sad 

echo on 

of f 

term characteristics, 


indicates 


sValue to set to 


(TCP, IGNORE »Csls1s131) 


sindicates which terminal characteristic 
swere requested 


(TCRs IGNORE »Dylslyl91) 
31s 


in response 


also is reflected by remote 


swhen terminal characteristics are sent 


(HST ,BAD sCs050,050) 341 
sports 
sbyte 

(CLP +BADsAs0505050) +42 

(CLR, IGNOR2Z,.F5050;,0;0) +43 

(BKO,BAD,H»0,0,0-0) +44 

(BOC, TYMBOCsBs030,0;,0) 345 

(BIN,»,BADsHs0,01030) +46 

CINB,TYMINB,D,0,0,0,0) +47 

CINE,TYMINE».D.0,0,0;0) 350 

CINT,s TYMINT,D30,0,0,0) 351 

(I1RQ,BAD,B,.0,0,0,0) +52 

( IHR» TYMIHR,sD50,0,0;0) $53 

(ORQ,BADsBs050,0,50) 754 

(QHR, TYMOHR.B,0,0,0,0) +55 

(NEG, IGNORE ,C+0,0;0;0) 356 

(BRK, IGNORE .,B,0,0,0,0) 357 

(PSR,IGNORE,C.0:0,0,0) +60 


C(EAQsBADsB 50305040) 361 


in port byte, 


host up and answereing with # 
and host # in data 


SUPER CLOCK INFO REQUEST 
SUPER CLOCK INFO 

START BLK OUTPUT 

BLK OUPTUT COMPLETE 
START BLK INPUT 
BLK INPUT DONE, 
BLK INPUT DONE, COMPLETED 

BLK INPUT DONE, TIMEOUT 

RQ@ST BLK INPUT TERMINATION 
BLK INPUT DONE, HOST REQUEST 
R@ST BLK OUTPUT TERMINATION 
BLK OUTPUT DONE, HOST REQUEST 
BLK IG PORT NEGOTIATION 

BREAK CHR RECVD 
PORT STATUS 
ENTER ALT QUTPUT 


OUT OF BUFFER 


DEVICE MODE 


data has been lost from 
the data filed may tell how 


first data 
indicates which characteristics 
;second data byte 


337 term characteristcs probe, data byte 
3740 term characteristcs response; data 


just like tcS+s comes 
>to a probes 


of 


NOTES ON AUX CIRCUIT QUEUEING: 
GLOSSARY: 


OB = destination job for which aux circuit is queued 
(a negative DJOGB usually means SYSNDX slot #) 
SJOB = source job which queued aux circuit 


EDBITS @ internal status bits associated with DOJOB 
UDBITS = user settable status bits associated with DJOB 


ESBITS = internal status bits assoctated with SJOB 
US8ITS ™ user settable status bits associated with SJOB 


SYSNDOX = index into SYSNDX table. system jobs enter themselves 
into predetermined SYSNDX slots to give aux circuit 
queuers a handle on those system jobs. this allows for 
listeneing socket style communications with system jobs 
similar to the way the arpanet does things. 


HOST TQ HOST PROTOCOL = talked by local and remote hasts white 
establishing aux circulitse 


The HOST TG HOST protocol looks Tike 200,Fs00,01s02,03,200 


where = function (O=EXEC, 1=QUEUE) 


F 
Dn = data bytes (only hi 4 bits of D3 siqnificant) 


F=O0 (EXEC) © DOsDI.«D2shi D3 
F=1 (QUEUE): DO,D1,D2;,;hi 03 


IGNORED, should be 0 
UDBITS,,0J0B right justified 
neg DJOB => SYSNDX 


When an aux circuit ts established, the HOST TO HOST protocol is 
expected as the first bytes down the pipee Anything that does not 
look like the HOST TO HOST protocol is passed thru and the function is 
defaulted to EXEC. Note that at least one character is needed to make 
the determination as to whether or. not the user at the initiating end 
is talking the HOST TG HOST prototcol. If the initiating host does not 
talk the HOST TO HOST PROTOCOL and the target host does, it is 
reconmended that a garbage character be sent as the first character 
down the pipe to allow for this determination.e A rubout will be 
gobbled and not considered as part of the data stream. Any other 
character will be passed through to an exec. The rubout can be 
considered an escape character only if it is the first character down 
the pipe. 


SCENERIO OF TYPICAL USE GF AUX CIRCUIT QUEUEING: 


User on HOST A wants to talk to system process occupying SYSNDX slot N 
e HOST B via an aux circuit. (Such as a file transfer server). 


ON HOST A: 


User executes AUXBLD function of TYMOP jsys to establish aux circuit 
to HOST be User specifies F=QUEVE function and provides SYSNDX # N as 
“N job v in data bytes. Iqnore UDBITS for now. The user then hangs on 
a bin on the aux circuit waiting for a hello from the desired system 
DPrOCeSSe 


ON HOST Be 


HOST B starts up a job for that aux circuit just created which talks 
the HOST TO HOST PROTOCOL as part of its initialization. The job sees 
the F=QUEUE function desired and uses the QUEAUX function of FYMOP to 
queue the aux circuit for the indicated SYSNDX slot associated job. 
On success the fob logs out leaving the aux circuit flappings sitting 
in the queue tables. Eventually the target system process comes 
around and claims (via the CLMAUX function of TYMOP) the aux circuit 
and does whatever it is supposed to with it. Normally the system 
process would send some initial hello down the aux circuit which the 
user on HUST A would see since he is hanging on a bin on that aux 
circuite At this point the communication pipe to the system process 
is complete. 


ither end may release the aux circuit with the AUXRLS function of 
OP breaking the connection with zaps etc. 


PRETTY PICTURES: 
INTERNAL MONITOR FABLES OF INTEREST TO PROGRAMMERS 


“PASLE OF SYSNDX SLOTS AND CORRESPONDING JOB ##S: 
INDEXED BY SYSNDX % 


SYSNDX? ! JOB # ot 
=1 ! 


length is NSYSND 


TABLE OF DESTINATION JOB AUX CIRCUIT QUEUE ENTRIES: 
INDEXED BY LINE + 


AUXDJG=DUADJQ@TYMTTL 
9 bits 9 bits 18 bits 


DUXDJ@? ! EDBITS ! UDBITS ! JOB : 
: =I : 


length fs NTYMTT 


EDBITS: 1bO = job # obtained from SYSNDX 
UDBITS: user settable 


TABLE OF SUURCE JOB AUX CIRCUIT QUEUE ENTRIES: 
INDEXED BY LINE i 


AUXSJQ=DUX SJO=TYMTTL 
9 bits 9 bits 18 bits 


DUXSJO: ! ESBITS ! USBITS ! JOBE : 


! = : 


length is NTYMTT 


ESBITS: 1b0 = job loqqed out since queuing 
USBITS: user settable 


TABLE OF TIMEOUT AUX CIRCUIT QUEUE ENTRIES: 
INDEXED BY LINE 


AUXTMQ=DUX TIMQ=TYMTTL 


DUXTMQ: ! todclk at which timeout occurs ' 
! =] t 


length is NTYMTT 


s OCCUPIED 


>FREE 


>OCCUPIED 


sFREE 


sOCCUPTED 


sFREE 


;OCCUPIED 
sFREE 


TABLE GF HOST TO HOST PROTOCOL ENTRIES: 
INDEXED BY LINE % 


AUXCTL=DUXCTL®TYMTTL 


8 bits 8 bits 8 bits 8 bits 4 bits 


DUXCTL: ! P fr DO ! D1 ! De Yr O03 ! ;OCCUPIED 


: «1 § 5; FREE 


length is NTYMTT 
NOTE: only hi 4 bits of D3 retained 


NOTES GN BLOCK IO POH Not debugged yet *HEPRECdE: 


BLOCK IS 8 BIT BYTES PACKED 4 PER WORD LEFT JUSTIFIED 
BLOCK WILL NOT BE MORE THAN 512. WORDS LONG (1 PAGE) 

A BLOCK MUST START ON PAGE BOQUNDRY 

THE COUNT DOES NOT INCLUDE OTH WORD (1 <= COUNT <= 511.) 


;OTH WORD UF BLOCK IS OVERHEAD WORD. 

;COUNT IS 1 TRHU 777 AND DOES NOT INCLUDE THE OVERHEAD WORD. 
sRETURNED COUNT < DESIRED COUNT IS NOT CONSIDERED AN ERROR AND 
;MUST BE CHECKED BY THE USER. 


WHAT A BLOCK LOOKS LIKE: 


+0 : HEADER WORD : 


+] : 32 BITS (4 & BIT BYTES) ! IGNORED 4 BITS ! 


+2 : 32 BITS (4 & BIT BYTES) ! IGNORED 4 BITS ! 


+3 : 32 BITS (4 8 BIT BYTES) ! IGNORED 4 BITS ! 


0: 32 BITS (4 8 BIT BYTES) ! IGNORED ¢ BITS ! 


+777 =! 32 BITS (4 8 BIT BYTES) ! IGNORED 4 BITS ! 


OVERHEAD WORD (OTH WORD OF AN 10 BLOCK): 
AT TIME OF CALL: 
: 18 BITS ry 9 BITS ! 9 BITS § 


i 0 9 0 ! DESIRED COUNT : 


RETURNED (UNLESS INHIBITED) 


: 18 BITS +s 9 BITS 9 BITS : 


! XMFER ERROR BITS OR O »s RETURNED COUNT ! DESIRED COUNT ! 


sHEADER WORD ERROR BITS FOR XFER ERRORS 
KERB==400000 >OUT OF BUFFER ERROR 
KERT==200000 ;BASE TIMEQUT ERROR 


FUNCTIONS: 


1 = BUILD AUXILIARY CIRCUIT: (AUXBLD) 


a Set 


ACCEPTS: 


1l/ option bitsel,,0 


where option bits are: 60 Wait for AUXBLD process 


USE USERNAME PROVIDED IN 


O63 & OB4 => USE SYSTEM DEFAULT TYMNET USERNAME 
183 & 1684 => ERROR, CONFLICTING OPTION BITS 


2/ Asciz string pointer to signon string in user space 
3/ FsDATA where F=0O for EXEC and data is don't care 
F=1 for QUE for DJOB using udbits in data 
for F=l: data is UDBITS,,0J/08 right 
neq DJOB => SYSNDX 


Contents of 3 are specification of optional Host to Host 
Protocole If not specified, default Fs, DATA=0 is used. 


F is left justified 8 bits, DATA is rest of 36 bit word. 
RETURNS: 
+1 Error code in Is possibly supervisor error code in 2 


+2 Successs TTY designator in l 


If b3 is not lits any user name provided by the user in 
the sigqnon string is replaced with: 
Ob4: the contents of AUXNAM in the JSB if AUXNAM has been 
1b4: the system default aux circuit building username. 
AUXNAM is inited when a tymnet connection initiates a job. 
Only wheels and tymox priv may light b3 without error. 
When b3 Tits full user provided siqnon string is usede 


TYMNET LINE INFO: (GETLNS) 


ACCEPTS: 


i/ option bitSs2,,tty desiqnoator 
where option bits are: NONE 


RETURNS: 

+] error code in l 

+2 success, 2/ loqin info (TYNODS) 
3/ status bits (TYMLNS) 

INPUT BACK PRESSURE: (SETIBP) 


ACCEPTS: 


if busy 


= F»yDATA IS IN 3 FOR HOST TO HOST PR. 
B2 = DON'T SEND ANY HOST TO HOST PROT. 


2 


USE JOB'S ENTRY TYMNET USERNAME 


justified 


inited. 


l/ option bitSs3s-etty desiqnoator 
where option bits are: NONE 


RETURNS: 

+] error code in l 

+2 success, input back pressure set in TYMLNS (L8POF) 
4 = GET TYMNET LINE INTERRUPT INFO: (GETINS) 

ACCEPTS: 


1/ option bitss4setty desigqnoator 
where option bits are: NONE 


RETURNS: 
+] error code in l 
#2 success, 2/ ball code mask (TYMCMM) 
3/ terminal code (TYMCMI) 
5 «= SET TYMNET LINE INTERRUPT INFOS (SETINS) 
ACCEPTS: 
1/ option bitss5sstty desigqnoator 
where option bits are: NONE 
2/ ball code mask (TYMCMM) 
3/ terminal code (TYMCMI) 
RETURNS: 
+] error code in 1 
+2 success 
6 = QUEUE AN AUX CIRCUIT TTY FOR DJOB (QUEAUX) 
ACCEPT Ss: 
l/ option bitsSs6s,tty designator 
2/ 0,USBITS.,0 
3/ O,UDBITSs+<DJOB (or SYSNDX # if negative)> 
where option bits are: NGNE 
RETURNS: 
+] l/ error code 
+2 SUCCESS, aux circuit queued 
7 = CLAIM AUX CIRCUIT QUEUVED FOR US WHEN “"ANO" OF UDBITS NGN#*0 (CLMAUX) 
ACCEPTS? 


l/ option bitss7530 
2/ Os<UDBITS or O>,4,<DJ0OB (or SYSNDX if neq) if option bit 181 on> 


where option bits are: 
181 = DJOB tor SYSNDX if neg) in RH 2 ! REQUIRES WHEEL! 
183 = Listen if no jobs found 
NOTE: 161 OFF => (RH 2 <= JOBNO) 
NOTE: UOBITS IN 2 WILL BE USED ONLY IF NON#0 
(SINCE CG COULD NEVER WIN AND) 
RETURNS: 
+] error code in 1 
+2 success @ updated ACS in 1233 (3 gets SJOB stuff) 
10 © DEQUEUE AUX CIRCUIT (DEQAUX) 
ACCEPTS: 
1/ ootion bitSs10s,tty designator 
2/ O,<UDBITS or 0>5,,<DJ0B (or SYSNDX if negative)> 
3/ SJOB 
where option bits aret 
lbl = iqnore RH 2 and dequeue all jobs queued by SJOB 
183 = SJOB in 3 !REQUIRES WHEEL! 
1684 = tty designator in 1 (ignore 2) 
NOTE: UOBITS IN 2 WILL BE USED ONLY IF NON=0 
(SINCE O COULD NEVER WIN AND) 
RETURNSS 
+] error code inl 
+2 success, ACS 152+3 updated 
11 = SET SYSNDX ENTRY (SETSYS) '!REQUIRES WHEEL! 
ACCEPTS: 
l/ option bitssil,,0 
2/ SYSNOX 
3/ JOB # 
where option bits are: 180 = JUB # in 3 
RETURNS: 
+1 1/ ERROR CODE 
+2 ENTERED 
l2 = CLEAR SYSNDX ENTRY (CLRSYS) fREQUIRES WHEEL! 
ACCEPTS: 


1/ option bitss,s125,0 
2/ SYSNDX 


where option bits are: NONE 

RETURNS: 

#1 1/ error code 

+2 cleared, 1/ previous contents just clobbered 
13 = GET SYSNDX ENTRY (GETSYS) 

ACCEPTS: 


1/ option bits,13,,0 
2/ SYSNDX 


where option bits are: NONE 
RETURNS: 


+] i/ error code 
+2 1/ contents, "1 if free 


14 = RELEASE AUX CIRCUIT (AUXRLS) 
ACCEPTS: 
i/ option bitsSs14s,tty designator 
where option bits are: NONE 
RETURNS: 
+l error code in l 
#2 success 

15 = GET LAST RECVD BALL CODE (GETCMD) 
ACCEPTS: 
1/ option bits,15,,tty designator 
where option bits are: NONE 
RETURNS: 


+] error code inl 
+2 2/ ball code, subtype, data in bytes Orls2 


16 = SEND BALL CODE (SNDCMD) 
ACCEPTS: 


l/ option bits,16s,tty desigqnator 
2/ ball code. Subtype, data in bytes O41,;2 


RETURNS: 


+1 error code inl 


+2 success 


17 = SET BLOCK MODE INPUT FOR LINE (SETBKI) 
ACCEPTS: 


i/ option bits,1i7-stty desiqnoator 
where option bits are: 
BO IF BLOCK MODE DESIRED, OFF IF NOT 


RETURNS: 


+1 error code in l 
+2 successs BLK MODE FLAG set/cleared in TYMLNS (BLKMOD) 
NODE NOTIFIED APPROPRIATELY 


20 = SET BLOCK MODE OUTPUT FOR LINE (SETBKO) 
ACCEPTS: 


l/ option bitss20,s,tty desiqnoator 
where option bits are: 
BO IF BLOCK MODE DESIRED, OFF IF NOT 


RE TURNSS 


+1 error code in 1 
+2 success, BLK MODE FLAG set/cleared in TYMLNS (BLKMOD) 
NODE NODTFIFIED APPROPRIATELY 


21 = GET 1G BLOCK FOR LINE (GETBLK) 
ACCEPTS: 


1/ option bitss2ls,tty designoator 
where option bits are: 
BO: 1 = POKE TERMINAL INT 33 ON COMPLETION 
O = WAIT FOR COMPLETION 
Bil: 1 = DON'T RETURN STATUS IN BLOCK HEADER WROD 
O = ALLOW RETURN OF STATUS IN BLOCK HEADER WROD 
2/ START ADR OF BLOCK (ON PAGE BOGUNDRY) 


RETURNS: 


+1 error code in l 
+2 success; UPDATED OTH WORD IN BLOCK IF APPROPRIATE 


22 = SEND I0 BLOCK FOR LINE (SNDBLK) 
ACCEPT S? 


1/ option bits,22s,tty designoator 
where option bits are: 
BO: 1 © POKE TERMINAL INT 34 ON COMPLETION 
O = WAIT FOR COMPLETION 
Bl: 1 © DON'T RETURN STATUS IN BLOCK HEADER WROD 
OQ = ALLOW RETURN OF STATUS IN BLOCK HEADER WRD 
2/ START AOR OF BLOCK (ON PAGE BOUNDRY) 


RETURNS: 


+1 error code inl 
+2 success, UPDATED OTH WORD IN BLOCK IF APPROPRIATE 


ERROR CODES FOR TYMOP JSYS: 


IXX1=601 200 

MXX2=601201 
TYMXX3=601 202 
TYMXX4=601203 
TYMXX5=601 204 
TYMXX6=601 205 
TYMXX 7=601206 
TYMXX& =601207 
TYMXX9=601210 
TYMX10=601 211 
TYMX11=601212 
TYMX12=601213 
TYMX13=601214 
TYMX14=601215 
TYMX15=601216 
TYMX16=601217 
TYMX17=601220 
TYMX18=601221 
TYMX19=601222 
TYMX20=601223 
TYMX21=601 224 
TYMX22=601225 
TYMX23=601 226 
TYMXA24=601 227 


6.1: 


sAUX CIRCUIT BUILDING MECHANISM BUSY 

sAUX CIRCUIT BUILDING MECHANISM TIMED OUT 
sNO FREE LINE AVAELABLE 

sLINE MYSTERIOUSLY ZAPPED PREMATURELY 
s;SUPERVISOR REPORTS ERROR 

sILLEGAL RECEIVE BITS REQUEST 

sILLEGAL TYMOP FUNCTION CODE 

;ILLEGAL TYMNET TTY 

s;JOB DOES NOT OWN TTY 

s INSUFFICIENT CAPS 

sILLEGAL JOB + 

sILLEGAL SYSNDX 

s;SYSNDX SLOT ALREADY OCCUPIED 

sSYSNOX SLOT NOT CURRENTLY OCCUPIED 
sILLEGAL AUX TTY OR IN BAD STATE 

sAUX TTY NOT QUEUED BY JOB 

sNOQ JOBS QUEUED 

3sBAD AUX CIRCUIT FUNCTION SPECIFIED 

sAUX CIRCUIT NOT IN BLOCK 1/0 MUDE 

3AUX CIRCUIT NOT IN NON*BLOCK MODE 

31/0 BLOCK DOES NOT START ON PAGE BOUNDRY 
ILLEGAL I/O BLOCK WORD COUNT 

sTTY IS NOT ASSOCIATED WITH AN AUX CIRCUIT 
s;BLK 10 XFER ERROR, ERROR BITS IN LH OF BLOCK 


